home *** CD-ROM | disk | FTP | other *** search
/ NASA Climatology Interdisciplinary Data Collection / NASA Climatology Interdisciplinary Data Collection - Disc 4.iso / software / grads / lib / sample.gui < prev    next >
Text File  |  1998-04-23  |  12KB  |  261 lines
  1. #  sample.gui - last revision: October 12, 1997
  2. #
  3. #  Sample widget script with tutorial comments. Modify it for
  4. #  your own taste and needs.
  5. #
  6. #  How to invoke this script:
  7. #
  8. #  At startup. Set the enviroment variable GAGUI with the
  9. #  name of the script file, e.g., 
  10. #
  11. #  % setenv GAGUI sample.gui
  12. #
  13. #  At the GrADS command line prompt. Simply type
  14. #
  15. #  ga> gui sample.gui
  16. #
  17. #  Of course, you must have a version of GrADS built with
  18. #  Athena Widgets support.
  19. #
  20. #  --
  21. #   (c) 1997 by Arlindo da Silva
  22. #
  23. #   Permission is granted to any individual or institution to use,
  24. #   copy, or redistribute this software so long as it is not sold for
  25. #   profit, and provided this notice is retained. 
  26. #
  27. #  See also sample2.gui, window.gui.
  28. #.........................................................................
  29.  
  30. #  Most "exec" commands are supported
  31. #  ----------------------------------
  32.    set gxout shaded
  33.    
  34. #  Set this to see the script echoed on the screen
  35. #  -----------------------------------------------
  36. #   Debug(on)
  37.  
  38. # A "label" is an inactive widget which display some text, 
  39. # e.g., an informative  title. The first argument, "root"
  40. # in this case, is the name you give to the widget so that
  41. # you can refer to it later on
  42. # -------------------------------------------------------
  43.   MakeLabel(root,"GrADS")
  44.  
  45. # This command creates a dropdown menu called " File "
  46. # as usual, the first argument "file" is the name of the
  47. # widget
  48. # -------------------------------------------------------
  49.   MakeMenu ( file, " File " )
  50.  
  51.  
  52. # Once you make a memu, you create its items. For the first item:
  53. # --------------------------------------------------------------
  54.       MakeMenuItem(open,  file, "Open",             Load,    "open")
  55.  
  56. # The parameters this particular item are:
  57. #     open    the name of the item widget
  58. #     file    the menu the item belongs to (see MakeMenu above)
  59. #     "Open"  This is the text it displays on the screen
  60. #     Load    this is the callback name, i.e., the widget invokes
  61. #             this function when pressed. This particular callback
  62. #             pops up a "file finder" widget, and after the user
  63. #             clicks on a file name it executes the grads command
  64. #             "open" (see last argument) on this file. A list
  65. #             of the other available callbacks can be found in the
  66. #             end of this file.
  67. #     "open"  Argument to be passed to the callback. In this 
  68. #             particular case, it is the GrADS command to be
  69. #             executed on the file.
  70. #  The definition of the other items in this menu follows.
  71.       MakeMenuItem(sdf,   file, "SDF Open",         Load,    "sdfopen")
  72.       MakeMenuItem(xdf,   file, "XDF Open",         Load,    "xdfopen")
  73.       MakeMenuItem(fsel,  file, "File Selection ",  FileSel, NULL )
  74.       MakeMenuItem(browse,file, "View Text File",   Browse,  NULL)
  75.       MakeMenuItem(junk,  file, "_______________",  NULL,    NULL )
  76.       MakeMenuItem(exec,  file, "Exec",             Load,    "exec")
  77.       MakeMenuItem(run,   file, "Run",              Load,    "run")
  78.       MakeMenuItem(gui,   file, "GUI",              Load,    "gui")
  79.       MakeMenuItem(junk,  file, "_______________",  NULL,    NULL )
  80.       MakeMenuItem(fresh, file, "Refresh",          Cmd,     "  ")
  81.       MakeMenuItem(init,  file, "Reinit",           Cmd,     "reinit")
  82.       MakeMenuItem(exit,  file, "Exit",             Cmd,     "quit")
  83.  
  84.  
  85. # Enough debugging...
  86. # -------------------
  87.   Debug(off)
  88.  
  89.  
  90. # A menu for gx metafile printing related commands
  91. # ------------------------------------------------
  92.   MakeMenu ( print, " Print " )
  93.       MakeMenuItem(printit, print, "Print",         Cmd,   "print")
  94.       MakeMenuItem(enable,  print, "Enable  Print", Load,  "enable print")
  95.       MakeMenuItem(disable, print, "Disable Print", Cmd,   "disable print")
  96.  
  97. # A menu with assorted internal options
  98. # -------------------------------------
  99.   MakeMenu ( options, " Options " )
  100.       MakeMenuItem(shade,  options, "Shaded",      Cmd, "set gxout shaded" )
  101.       MakeMenuItem(cont,   options, "Contour",     Cmd, "set gxout contour" )
  102.       MakeMenuItem(grfill, options, "Grid Fill",   Cmd, "set gxout grfill" )
  103.       MakeMenuItem(grvals, options, "Grid Values", Cmd, "set gxout grid" )
  104.       MakeMenuItem(vec,    options, "Vector",      Cmd, "set gxout vector" )
  105.       MakeMenuItem(strm,   options, "Streamlines", Cmd, "set gxout stream" )
  106.       MakeMenuItem(bar,    options, "Bar Chart",   Cmd, "set gxout bar" )
  107.       MakeMenuItem(line,   options, "Line Plot",   Cmd, "set gxout line" )
  108.       MakeMenuItem(barb,   options, "Wind Barbs",  Cmd, "set gxout  barb" )
  109.       MakeMenuItem(junk,   options, "_______________",  NULL, NULL )
  110.       MakeMenuItem(ci,     options, "Contour Interval",  CmdStr, "set cint" )
  111.       MakeMenuItem(tit,    options, "Draw Title", CmdStr, "draw title " )
  112.       MakeMenuItem(cbar,   options, "Color Bar",  Cmd, "run cbarn" )
  113.  
  114. # A menu for defining GrADS dimensions. This is very crude right now.
  115. # I will be developing a specific callback with rubber bands
  116. # etc. for these functions. Stay tuned. 
  117. # ------------------------------------------------------------------
  118.   MakeMenu( dim, "Dim")
  119.       MakeMenuItem(lat,  dim, "Latitude",  CmdStr, "set lat " )
  120.       MakeMenuItem(lon,  dim, "Longitude", CmdStr, "set lon " )
  121.       MakeMenuItem(lev,  dim, "Level",     CmdStr, "set lev " )
  122.       MakeMenuItem(time, dim, "Time",      CmdStr, "set time " )
  123.       MakeMenuItem(junk, dim, "_________", NULL,   NULL )
  124.       MakeMenuItem(x,    dim, "x",         CmdStr, "set x " )
  125.       MakeMenuItem(y,    dim, "y",         CmdStr, "set y " )
  126.       MakeMenuItem(z,    dim, "z",         CmdStr, "set z " )
  127.       MakeMenuItem(t,    dim, "t",         CmdStr, "set t " )
  128.  
  129.  
  130. # Creates simple buttons. Buttons work pretty much like menu items
  131. # but they do not belong to any menu and are directly clickable.
  132. # ------------------------------------------------------------------
  133.   MakeButton( clear,  "Clear",      Cmd,      "clear" )
  134.   MakeButton( quit,   "Quit",       Cmd,      "quit" )
  135.   MakeButton( rein, "Reinit", Cmd,     "reinit")
  136.   MakeButton( prompt, "ga>",  CmdWin,  NULL )
  137.  
  138. # Buttons (and toggle) for displaying the default expression
  139. # ----------------------------------------------------------
  140.   MakeButton( var,  "Var",    VarSel,  NULL )
  141.   MakeToggle( hold, "Hold",   FALSE,  NULL, Toggle,  "hold" )
  142.   MakeButton( prev, " << ",   Display, "<<" )
  143.   MakeButton( play, "Display",   Display, "DISPLAY" )
  144.   MakeButton( next, " >> ",   Display, ">>" )
  145.  
  146. # Once you define buttons and menus you need to enforce their
  147. # relative position. The very first button is always placed at the
  148. # upper left corner.
  149. # ----------------------------------------------------------------
  150.  
  151.   # First row 
  152.   SetWidgetPos(file,    PLACE_UNDER, root, NO_CARE, NULL)
  153.   SetWidgetPos(print,   PLACE_UNDER, root, PLACE_RIGHT, file )
  154.   SetWidgetPos(options, PLACE_UNDER, root, PLACE_RIGHT, print )
  155.   SetWidgetPos(dim,     PLACE_UNDER, root, PLACE_RIGHT, options )
  156.   SetWidgetPos(rein,  PLACE_UNDER, root, PLACE_RIGHT, dim )
  157.   SetWidgetPos(prompt,  PLACE_UNDER, root, PLACE_RIGHT, rein )
  158.  
  159.   # Second row
  160.   SetWidgetPos(hold,  PLACE_UNDER, file, NO_CARE, NULL)
  161.   SetWidgetPos(var,   PLACE_UNDER, file, PLACE_RIGHT, hold )
  162.   SetWidgetPos(prev,  PLACE_UNDER, file, PLACE_RIGHT, var )
  163.   SetWidgetPos(play,  PLACE_UNDER, file, PLACE_RIGHT, prev )
  164.   SetWidgetPos(next,  PLACE_UNDER, file, PLACE_RIGHT, play )
  165.   SetWidgetPos(clear, PLACE_UNDER, file, PLACE_RIGHT, next )
  166.   SetWidgetPos(quit,  PLACE_UNDER, file, PLACE_RIGHT, clear )
  167.  
  168.  
  169. # You can optionally select a font for ALL widgets
  170. # ------------------------------------------------
  171. # GetFont(font,"-*-helvetica-bold-o-normal--*-*-*-*-*-*-*-*" )
  172.   GetFont(font,"-*-helvetica-bold-o-normal--12-*-*-*-*-*-*-*" )
  173.   AllWidgetFont(font)
  174.  
  175. # And select a font for an individual widget. Here is one example:
  176. # ---------------------------------------------------------------------
  177.   GetFont(myfont,"-*-helvetica-bold-o-normal--14-*-*-*-*-*-*-*" )
  178.   SetWidgetFont(root,myfont)
  179.  
  180. # In order to make your widgets appear on the screen you *must*
  181. # issue this command.
  182. # -------------------------------------------------------------
  183.   ShowDisplay()
  184.   
  185.  
  186. # After your widgets appear on the screen, you can set the color 
  187. # of your widgets. The following colors are pre-defined:
  188. # white, back, red, green, blue, yellow.
  189. # --------------------------------------------------------------
  190.   GetNamedColor(gray,"grey")
  191.   GetNamedColor(Blue,"LightSkyBlue")
  192.   GetNamedColor(pink,"gold")         # pink is actually gold, get it?
  193.   AllFgColor(black)
  194.   AllBgColor(Blue)
  195.   SetBgColor(root,white)
  196.   SetFgColor(root,red)
  197.   SetFgColor(prompt,yellow)
  198.   SetBgColor(prompt,red)
  199.   SetBgColor(prev,pink)
  200.   SetBgColor(play,pink)
  201.   SetBgColor(next,pink)
  202.   SetBgColor(hold,gray)
  203.   SetBgColor(var,gray)
  204.   SetBgColor(clear,gray)
  205.   SetBgColor(rein,gray)
  206.   SetBgColor(quit,gray)
  207.  
  208. # And you must call this function at the end of your first GUI script.
  209. # This instructs the X Toolkit to enter an infinite loop, monitoring
  210. # keyboard and mouse events. Repeating: you *must* call MainLoop().
  211. # -------------------------------------------------------------------
  212.   MainLoop()
  213.  
  214. #........................................................................
  215. #
  216. # APPENDIX: Currently available callback functions
  217. #
  218. #     Browse    Opens a text file, such as a help file, on a separate
  219. #               window.
  220. #     Cmd       Executes a generic GrADS command
  221. #     CmdStr    Like Cmd, but the user is prompted for an additional
  222. #               string to be appended to the GrADS command.
  223. #     CmdWin    Invokes a window for GrADS command line interface.
  224. #               User can click on past commands from a list.
  225. #     CmdLine   Invokes the standard GrADS command line interface.
  226. #               When the command line is active the other widgets
  227. #               are not available (may be fixed in the future).
  228. #     Display   A generic callback for displaying the current variable
  229. #               (or expression) set with VarSel. The options are:
  230. #                  <<    decrements time and executes display
  231. #                 PLAY   starts animation from current to last time
  232. #                DISPLAY just executes display
  233. #                  >>    increments time and  executes display
  234. #               If the "hold" toggle state is OFF (the default),
  235. #               the screen is cleared before displaying.
  236. #     Edit      Like browse, but the user can edit the file. This simple
  237. #               text editor is integrated with GrADS, providing a very
  238. #               elementary Integrated Development Enviroment (IDE) for
  239. #               GrADS scripts. In particular, the script being edited
  240. #               can be executed by clicking on a button (not
  241. #               implemented yet).
  242. #     FileSel   Pops up a scrollable list and asks the user to selected
  243. #               a file among the currently opened GrADS files (including
  244. #               SDFs). The selected file becomes the default.
  245. #     Load      Pops up a "file finder" widget, and after the user
  246. #               clicks on a file name it executes a GrADS command
  247. #               specified as the last argument.
  248. #     Open      Similar to Load, but the file name must be specified.
  249. #     Toggle    Turn internal options ON/OFF. The only internal
  250. #               option currently supported is "hold". This callback is
  251. #               usually used with MakeToggle(), see example above.
  252. #     VarSel    Pops up a scrollable list and asks the user to selected
  253. #               a variable from the default file. The user can also
  254. #               type a generic GrADS expression instead of selecting
  255. #               a single variable.
  256. #     NULL      Does not do anything, used for inactive buttons.
  257. #
  258. #........................................................................
  259.  
  260.  
  261.